home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / terms / kermit / b / ikmker.ins < prev    next >
Encoding:
Text File  |  1993-06-29  |  14.3 KB  |  319 lines
  1. MUSIC/SP Kermit 4.2.n Installation Instructions
  2.                      (1993 June)
  3.  
  4. Get the necessary files from the Kermit distribution tape or from BITNET
  5. KERMSRV or elsewhere.  Note that many of the files are generic for
  6. Kermit-370 and may already be available from a local CMS or TSO site.  As
  7. distributed by Columbia, the files are named as follows, all with prefix
  8. IKM or IK0 (I K Zero):
  9.  
  10.    IKMGUP.ASM  Assembler source for MUSIC-specific part of GUPI
  11.    IKMKER.BWR  A "beware" file, listing known bugs and problems
  12.    IKMKER.DOC  MUSIC Kermit User Guide, plain text
  13.    IKMKER.HLP  Kermit-MUSIC short help file
  14.    IKMKER.INS  Kermit-MUSIC installation instructions (this file)
  15.    IKMKER.UPD  Updates for MUSIC version of Kermit-370
  16.    IKMMAC.ASM  Assembler source for MUSIC-specific macros
  17.    IKMUTL.ASM  Assembler source for MUSIC-specific routines
  18.    IK0CMD.ASM  Assembler source for command handler
  19.    IK0COM.ASM  Assembler source for global code
  20.    IK0DEF.ASM  Assembler source for parameter definitions
  21.    IK0DOC.ASM  Assembler source with brief history
  22.    IK0GUP.ASM  Assembler source for generic update program GUPI
  23.    IK0KAN.ASM  Assembler source for Kanji character translation
  24.    IK0MAC.ASM  Assembler source for generic Kermit macros
  25.    IK0MAI.ASM  Assembler source for storage initialization
  26.    IK0PRO.ASM  Assembler source for generic routines
  27.  
  28. The following files are not necessary for installation, but may be of
  29. some interest.
  30.  
  31.    IKCACT.ASM  Assembler source for optional accounting exit routine
  32.    IKMHDR.MSS  Scribe source for producing IKMKER.DOC
  33.    IKMKER.ANN  Text of Kermit-MUSIC 4.2 announcement
  34.    IKMKER.LPT  Line-printer (paginated) equivalent of IKMKER.DOC
  35.    IKMKER.MSS  Scribe source for MUSIC part of IKMKER.DOC
  36.    IKMKER.PS   PostScript equivalent of IKMKER.DOC
  37.    IK0AAA.HLP  Implementation notes for 4.2
  38.    IK0CON.HLP  Notes on supporting other terminal controllers
  39.    IK0KER.ANN  Text of generic Kermit-370 4.2 announcement
  40.    IK0KER.MSS  Scribe source for generic part of IKMKER.DOC
  41.    IK0KER.UPD  Update history for Kermit-370
  42.    IK0POR.HLP  Notes on porting Kermit-370 to other systems
  43.    IK0VER.FOR  Comparison program for generating update decks
  44.  
  45. Kermit-MUSIC installation consists at present of a few small jobs that
  46. (a) build GUPI (Generic Update Program), (b) use GUPI to apply the
  47. current fixes to the base code, and (c) assemble and link the updated
  48. Kermit source.  The source for Kermit and GUPI itself is in many pieces,
  49. some generic for Kermit-370 and some specific to MUSIC.  All the
  50. necessary pieces are sequenced in columns 73-80 so that the numbers form
  51. a strictly increasing sequence when the pieces are correctly "pasted"
  52. together.  It is important to preserve the original sequence numbers so
  53. that updates, if any, can be applied to the source.
  54.  
  55. The following jobstreams assume that all source modules are stored under
  56. the code $KRM.  It also assumes that the source files have an extension
  57. of .S as opposed to .ASM.
  58.  
  59. To create a runnable version:
  60.  
  61. 1. Collect the following "ASM" files from the Kermit distribution onto
  62.    the code $KRM with RECFM FC and LRECL 80: IK0DOC, IK0MAC, IKMMAC,
  63.    IK0DEF, IK0MAI, IK0COM, IK0CMD, IKMUTL, IK0KAN, IK0PRO, IK0GUP, and
  64.    IKMGUP.  The files must have an extension of ".S".  Therefore, the
  65.    files should be called:
  66.  
  67.               $KRM:IK0DOC.S
  68.               $KRM:IK0MAC.S
  69.               $KRM:IKMMAC.S
  70.               $KRM:IK0DEF.S
  71.               $KRM:IK0MAI.S
  72.               $KRM:IK0COM.S
  73.               $KRM:IK0CMD.S
  74.               $KRM:IKMUTL.S
  75.               $KRM:IK0KAN.S
  76.               $KRM:IK0PRO.S
  77.               $KRM:IK0GUP.S
  78.               $KRM:IKMGUP.S
  79.  
  80. 2. Assemble the Generic Update Program GUPI.  This program is required
  81.    to apply the base mods to the Kermit-MUSIC source.  Before assembling
  82.    the GUPI program, you must change the IK0GUP module.  Edit the file
  83.    $KRM:IK0GUP.S and convert all COPY pseudo-instructions into macro
  84.    invocations.  This is easily achieved by removing the word "COPY"
  85.    from in front of the copy block's name.  There are only 5 occurences
  86.    of this and they are all in column 10.  The source for GUPI consists
  87.    of the combination IK0MAC, IKMMAC, IKMGUP, and IK0GUP.  The following
  88.    jobstream can be used to assemble the GUPI module.
  89.  
  90.       /FILE SYSPUNCH N($KRM:GUPI.OBJ) NEW(REPL)
  91.       /FILE SYSLIB PDS($MCM:*.M,$MCU:*.M) DEF
  92.       /FILE SYSUT1 N(&&TEMP) NEW DELETE RECFM(V) SP(300) DEF
  93.       /FILE SYSUT2 N(&&TEMP) NEW DELETE RECFM(V) SP(300) DEF
  94.       /FILE SYSUT3 N(&&TEMP) NEW DELETE RECFM(V) SP(300) DEF
  95.       /SYS TIME=MAX
  96.       /LOAD ASM
  97.       /JOB NOGO
  98.       /OPT XREF,DECK
  99.       /INC $KRM:IK0MAC.S
  100.       /INC $KRM:IKMMAC.S
  101.       /INC $KRM:IKMGUP.S
  102.       /INC $KRM:IK0GUP.S
  103.  
  104. 3. Link the object deck created by the previous step, producing
  105.    $KRM:GUPI.LMOD.  The following jobstream will do this.
  106.  
  107.       /FILE LMOD N($KRM:GUPI.LMOD) NEW(REPL) RECFM(F) LRECL(80)
  108.       /LOAD LKED
  109.       /JOB MAP,NOGO,PRINT,STATS,NAME=GUPI,MODE=OS
  110.       .ORG 4A00
  111.       /INC $KRM:GUPI.OBJ
  112.  
  113. 4. Create the GUPI program file from the following JCL.
  114.  
  115.       /SYS NOPRINT,REGION=1024
  116.       /FILE LMOD N($KRM:GUPI.LMOD)
  117.       /LOAD XMON
  118.       GUPI
  119.  
  120. 5. Build the base Kermit source so that you can apply modifications over
  121.    it.  Merge the source files in the order IK0DOC, IK0MAC, IKMMAC,
  122.    IK0DEF, IK0MAI, IK0COM, IK0CMD, IKMUTL, IK0PRO, and save the result
  123.    as $KRM:KERMIT.BASE.S. You will have to enlarge the editor workfile
  124.    to 15000 records. Make a local copy of the EDITOR file and change
  125.    the NREC parameter for the workfile from 6000 to 15000.
  126.  
  127.    IK0KAN.S is optional.  Including it adds about 32 Kbytes to the
  128.    Kermit program.
  129.  
  130.       /PARM NEW
  131.       /INC EDITOR
  132.       MERGE $KRM:IK0DOC.S
  133.       MERGE $KRM:IK0MAC.S
  134.       MERGE $KRM:IKMMAC.S
  135.       MERGE $KRM:IK0DEF.S
  136.       MERGE $KRM:IK0MAI.S
  137.       MERGE $KRM:IK0COM.S
  138.       MERGE $KRM:IK0CMD.S
  139.       MERGE $KRM:IKMUTL.S
  140.       MERGE $KRM:IK0KAN.S
  141.       MERGE $KRM:IK0PRO.S
  142.       PURGE $KRM:KERMIT.BASE.S
  143.       FILE $KRM:KERMIT.BASE.S
  144.  
  145. 6. Apply the updates using GUPI.  Note: this operation requires a region
  146.    of at least 1024K.  The following command will apply the fixes to the
  147.    source module $KRM:KERMIT.BASE.S using the update file
  148.    $KRM:IKMKER.UPD and save the updated source in $KRM:KERMIT.S.
  149.  
  150.           GUPI $KRM:KERMIT.BASE.S $KRM:IKMKER.UPD $KRM:KERMIT.S
  151.  
  152. 7. Assemble the Kermit source with the following jobstream.
  153.  
  154.       /FILE SYSPUNCH N($KRM:KERMIT.OBJ) NEW(REPL)
  155.       /FILE SYSLIB PDS($MCM:*.M,$MCU:*.M) DEF
  156.       /FILE SYSUT1 N(&&TEMP) NEW DELETE RECFM(V) SP(300) DEF
  157.       /FILE SYSUT2 N(&&TEMP) NEW DELETE RECFM(V) SP(300) DEF
  158.       /FILE SYSUT3 N(&&TEMP) NEW DELETE RECFM(V) SP(300) DEF
  159.       /SYS TIME=MAX
  160.       /LOAD ASM
  161.       /JOB NOGO
  162.       /OPT XREF,DECK
  163.       /INC $KRM:KERMIT.S
  164.  
  165. 8. Link the object deck created by the previous step together with
  166.    MATCH and MFINDX to produce $KRM:KERMIT.LMOD.
  167.  
  168.       /FILE LMOD N($KRM:KERMIT.LMOD) NEW(REPL) RECFM(F) LRECL(128) SHR
  169.       /LOAD LKED
  170.       /JOB MAP,NOGO,PRINT,STATS,NAME=KERMIT,MODE=OS
  171.       .ORG 4A00
  172.       /INC $KRM:KERMIT.OBJ
  173.       /INC $SUB:MATCH.OBJ
  174.       /INC $SUB:MFINDX.OBJ
  175.  
  176. 9. Save the following jobstream in the file $KRM:KERMIT.  This will
  177.    execute the KERMIT program with the proper system parameters.
  178.    The file MUST be saved as a PUBL,XO file so that the program
  179.    privileges are assigned properly by the system.
  180.  
  181.         /SYS NOPRINT,REGION=256
  182.         /FILE LMOD N($KRM:KERMIT.LMOD) SHR
  183.         /LOAD XMON
  184.         KERMIT
  185.  
  186. 10. Kermit-MUSIC requries the LSCAN privilege since it does a save
  187.     library scan directly.  You must modify either the system module
  188.     LOOKUP or the macro invoked by LOOKUP called $MCM:USERTBL.M.  Add
  189.     the line
  190.  
  191.           FILNAM '$KRM:KERMIT',(LSCAN,0)
  192.  
  193.     to either of the two files.  Reassemble the module LOOKUP and make
  194.     sure that the new object deck is used to when rebuilding the
  195.     nucleus.  If you do not give Kermit this privilege, the program will
  196.     abend on user codes that do not have LSCAN.
  197.  
  198. 11. Copy the file IKMKER.HLP to the MUSIC file $KRM:SYSTEM.KERMHELP
  199.     and save it as a PUBLIC file. This file is displayed when the
  200.     HELP subcommand is issued to Kermit-MUSIC.
  201.  
  202.                     * * Accounting Routine * *
  203.  
  204. If you wish to use the optional accounting exit routine with Kermit,
  205. you must create the object for it (using a procedure similar to step 7)
  206. and load it explicitly with Kermit (by adding another /INC to step 8).
  207. The sample currently available was written for CMS and must be adapted
  208. to run under MUSIC.  Any user who does so is urged to contribute the
  209. MUSIC version for inclusion in the Kermit distribution under the name
  210. IKMACT.ASM.  Even when such a MUSIC-specific sample is available, you
  211. should examine the source and customize it to your installation's needs
  212. before using it.
  213.  
  214.                        * * Configuration * *
  215.  
  216. The IBM mainframe and its communications front end (3705, 7171, etc.)
  217. usually require that parity be used by any asynchronous ASCII device
  218. that wishes to communicate with it.  Exactly which kind of parity is
  219. site-dependent.  At Columbia, the 3705 requires Mark parity, and the
  220. 7171 requires Even parity.  Make sure your users know to use the
  221. appropriate parity setting, as well as any other settings required for
  222. IBM mainframe communication (see p.36-39 of the Kermit book).
  223.  
  224. For linemode transfers, the ASCII/EBCDIC translation in the front end is
  225. a key factor.  Kermit-MUSIC uses an ASCII/EBCDIC translation table which
  226. conforms to the one given in the IBM System/370 Reference Summary.  If
  227. your site's translation table is incompatible with the one Kermit uses,
  228. then enter the appropriate SET ATOE/ETOA/TATOE/TETOA subcommands in the
  229. SYSTEM KERMINI file.  As long as the system tables are invertible with
  230. respect to the printable ASCII characters (even if the A-to-E and E-to-A
  231. tables are not the inverses of each other), the SET subcommands can
  232. compensate.  However, if your system's ASCII/EBCDIC tables are not
  233. invertible, Kermit will not and cannot work; you must change your
  234. system's tables.  Refer to the generic Kermit-370 chapter of the User's
  235. Guide for a step-by-step customization procedure (see the section on
  236. translation tables).
  237.  
  238. Kermit-MUSIC operation is possible for many types of protocol converters;
  239. it requires only that the converter have some kind of transparent mode.
  240. Be sure the converter is configured so that the graphics or transparent
  241. mode, whatever it is called, is enabled.  See IK0AAA.HLP for a list of
  242. front ends that are known to work and for a collection of notes and
  243. special warnings about some of them.  Some further installation details
  244. follow for specific devices.
  245.  
  246. When MUSIC Kermit is to be used with a 7171, make sure the 7171 is set up
  247. with its "keyboard lock delay" parameter set to 0.  Otherwise, the
  248. "terminal" will hang whenever MUSIC Kermit clears the screen.  This
  249. happens consistently when the parameter is set to 10, and not at all
  250. when set to 0.  For numbers in between, the higher the number, the more
  251. it happens.
  252.  
  253. There is another problem in the 7171 that can cause Kermit file
  254. transfers to abort after a flurry of retransmissions if XON/XOFF flow
  255. control is used by the receiving Kermit, or even by hardware in between
  256. the 7171 and the receiver.  To prevent this problem, set the 7171 flags
  257. so that XOFF is not a valid terminator of a transparent read.  See page
  258. 4-20 of "IBM 7171 Reference Manual and Programming Guide" (IBM
  259. publication number GA27-0021).
  260.  
  261. Kermit operation through a Renex protocol converter generally requires
  262. that type-ahead be turned off.
  263.  
  264. Kermit operation is possible through an IBM 3708 front end in two
  265. different configurations.  In the first, the terminal line must be set
  266. for either "protocol enveloping" or "dynamic" mode, and a session must
  267. be set for line-at-a-time operation for Kermit to work.  Other important
  268. details of the terminal configuration are: (1) the terminal must be
  269. specified as a TWX device, (2) the SSCP format should be set to USSNTO,
  270. (3) the terminal type ID should be set to 05, (4) the line should be set
  271. for 8, or possibly 7, data bits and 1 stop bit, (5) there should be no
  272. "read prompt", and (6) the so-called "alternate" translation table
  273. (number 3) should be selected.  Kermit-MUSIC may also need to be
  274. configured because some models of the 3708 (or some environments) do not
  275. pass the normal packet character SOH (code 1, CTRL-A).  A suitable
  276. substitute is HT (code 9, CTRL-I).  Alternatively, or additionally, it
  277. may help to set the 3708 "interface type" to 0.
  278.  
  279. The second possible 3708 configuration is "protocol conversion" mode and
  280. makes use of the FULLSCREEN type in Kermit, which is also suitable for
  281. many other kinds of protocol converter.  The basic setup consists of the
  282. following Kermit subcommands.
  283.  
  284.      .... mainframe .....        ....... PC .........
  285.      SET CONTROLLER FULL         set send start 62
  286.      SET RECEIVE START 62        set receive start 62
  287.      SET SEND START 62           set block b
  288.      SET BLOCK B                 set handshake none
  289.      SET HANDSHAKE 0
  290.  
  291. The 62's (Greater-than sign) may be replaced by some other decimal code
  292. for a printable character.  For best results, choose a character that
  293. seldom appears in the files you will be transferring.  In particular,
  294. avoid the Control, Eighth-bit, and Repeat prefixes.  Packet sizes are
  295. automatically restricted by Kermit-MUSIC, so you needn't set them unless
  296. conditions require packets shorter than the default (77).  Flow control
  297. may be needed to keep up with the data rate on some equipment.  The
  298. block check type should be set to "B" only if the protocol converter is
  299. overzealous in optimizing the data stream -- there are hazards in using
  300. any type other than "1" because of all the packet echoing.  Refer to
  301. IK0AAA.HLP for such details.  Note that the translation of characters
  302. imposes the same setup requirements on FULLSCREEN mode as on the
  303. traditional TTY mode (linemode).  See the DOC.
  304.  
  305. Kermit-MUSIC supports file transfers through the IBM 3174 AEA with B2
  306. microcode, but support is restricted to terminals with the ASCII
  307. Graphics capability in three ways that may require compensating
  308. installation:
  309.  
  310. a) The terminal type must be defined in the 3174 to support graphics
  311.    (only the built-in VT241 and Tektronix 4205 types plus suitable
  312.    user-defined terminal types).  IBM's AEA Reference describes how
  313.    to set up terminal tables.
  314.  
  315. b) The line must be defined without a Host Addressable Printer.
  316.  
  317. c) If the 3174 is owned by VTAM, the connection must be made with a
  318.    logmode that allows the Read Partition Query (such as M2SDLCQ).
  319.